home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / program / recio214.zip / RECIO.H < prev    next >
C/C++ Source or Header  |  1996-06-14  |  13KB  |  334 lines
  1. /****************************************************************************
  2.    MODULE: recio.h
  3.   PURPOSE: record input/output header file included in application
  4. COPYRIGHT: (C) 1994-1996, William Pierpoint
  5.   VERSION: 2.14
  6.   RELEASE: June 14, 1996
  7. *****************************************************************************/
  8.  
  9. #ifndef RECIO_H
  10. #define RECIO_H
  11.  
  12. /* include FILE and size_t types */
  13. #ifndef EOF
  14. #include <stdio.h>
  15. #endif
  16.  
  17. /* include struct tm and time_t types */
  18. #ifndef CLOCKS_PER_SEC
  19. #include <time.h>
  20. #endif
  21.  
  22. /* define SIZE_T_MAX */
  23. #ifndef SIZE_T_MAX
  24. #define SIZE_T_MAX (~(size_t)0)
  25. #endif
  26.  
  27. /* structure of REC abstract data type */
  28. typedef struct {
  29.         int      r_fd;       /* descriptor */
  30.         unsigned r_flags;    /* status flags */
  31.         FILE    *r_fp;       /* file pointer */
  32.   const char    *r_fname;    /* pointer to name of file */
  33.         long     r_recno;    /* record number */
  34.         unsigned r_fldno;    /* field number */
  35.         size_t   r_colno;    /* column number */
  36.         size_t   r_recsiz;   /* size of record buffer */
  37.         size_t   r_reclen;   /* length of record buffer */
  38.         char    *r_recp;     /* pointer to record buffer */
  39.         size_t   r_fldsiz;   /* size of field buffer */
  40.         char    *r_fldp;     /* pointer to field buffer */
  41.         int      r_fldch;    /* field separator character */
  42.         int      r_txtch;    /* text delimiter character */
  43.   const char    *r_tmfmt;    /* pointer to time format string */
  44.         int      r_cxtno;    /* context number */
  45. } REC;
  46.  
  47. /* structure of rpos_t abstract data type */
  48. typedef struct {
  49.         int      r_fd;       /* descriptor */
  50.         unsigned r_fldno;    /* field number  */
  51.         size_t   r_colno;    /* column number */
  52.         long     r_recno;    /* record number */
  53. } rpos_t;
  54.  
  55. /* constant expression macros */
  56. #define RECBUFSIZ   80       /* minimum size of record buffer */
  57. #define FLDBUFSIZ   20       /* minimum size of field buffer */
  58. #define RECFLDCH   ' '       /* record field separator character */
  59. #define RECTXTCH   ' '       /* text delimiter character */
  60. #define RECBEGYR  1951       /* year time format %y begins */
  61.  
  62. #define ROPEN_MAX   12       /* max no of rec streams open at same time */
  63. #define R_READ       0       /* read mode */
  64. #define R_WRITE      1       /* write/append mode */
  65.  
  66. /* compiler dependencies */
  67. #if defined (__BORLANDC__)
  68. #define NSBUFSIZ    34       /* string buffer sized for ltoa, dtoa, etc */
  69.  
  70. #ifndef TIME_T_MIN
  71. #define TIME_T_MIN  ((time_t)0)
  72. #endif
  73.  
  74. #ifndef TIME_T_MAX
  75. #ifndef LONG_MAX
  76. #include <limits.h>
  77. #endif
  78. #define TIME_T_MAX  ((time_t)LONG_MAX)
  79. #endif
  80.  
  81. #else
  82. #error For this compiler, you need to set:
  83. #error (1) NSBUFSIZ.  See DESIGN.TXT section 3.6.
  84. #error (2) TIME_T_MIN & TIME_T_MAX.  See DESIGN.TXT section 3.5.
  85. #endif
  86. extern char _r_nsbuf[NSBUFSIZ]; /* numeric to string conversion buffer */
  87.  
  88. /* enumerate errors */
  89. enum {
  90.     R_EDOM=1,                /* argument outside domain */
  91.     R_EINVAL,                /* invalid argument value */
  92.     R_EINVDAT,               /* invalid data */
  93.     R_EINVMOD,               /* invalid read or write mode */
  94.     R_EMISDAT,               /* missing data */
  95.     R_ENOMEM,                /* could not allocate memory */
  96.     R_ENOPUT,                /* failed put to stream */
  97.     R_ERANGE,                /* data out of range */
  98.     R_EFAULT                 /* unknown error */
  99. };
  100.  
  101. /* enumerate warnings */
  102. enum {
  103.     R_WEMPSTR=1,             /* data string empty */
  104.     R_WNOREG,                /* unable to register function (atexit full) */
  105.     R_WWIDTH,                /* column width too small for data */
  106.     R_WTMFMT,                /* date/time data incomplete */
  107.     R_WFAULT                 /* unknown warning */
  108. };
  109.  
  110. /* define static record streams */
  111. extern REC *recin;           /* recin  record pointer */
  112. extern REC *recout;          /* recout record pointer */
  113. extern REC *recerr;          /* recerr record pointer */
  114. extern REC *recprn;          /* recprn record pointer */
  115.  
  116. #define RECIN       -1       /* recin  context number */
  117. #define RECOUT      -2       /* recout context number */
  118. #define RECERR      -3       /* recerr context number */
  119. #define RECPRN      -4       /* recprn context number */
  120.  
  121. /* record status flags definitions */
  122. #define _R_COL       1       /* beginning column flag (bit 0) */
  123. #define _R_WRT       2       /* read/write stream flag (bit 1) */
  124. #define _R_TXT       4       /* current field text char indicator (bit 2) */
  125. #define _R_EOF     128       /* end-of-file indicator (bit 7) */
  126. #define _R_ERR     256       /* error indicator (bits 8-11) */
  127. #define _R_WRN    4096       /* warning indicator (bits 12-15) */
  128.  
  129. #define _R_ERRMAX   15       /* maximum error number */
  130. #define _R_WRNMAX   15       /* maximum warning number */
  131.  
  132. /* functions implemented as macros */
  133. #define rskipfld(rp)     (rskipnfld((rp), 1))
  134. #define rresetrec(rp)    (rsetrecstr((rp), rrecs(rp)))
  135. #define rnames(rp)       ((rp)->r_fname)
  136. #define rrecs(rp)        ((rp)->r_recp)
  137. #define rflds(rp)        ((rp)->r_fldp)
  138. #define rrecno(rp)       ((rp)->r_recno)
  139. #define rfldno(rp)       ((rp)->r_fldno)
  140. #define rcolno(rp)       ((rp)->r_colno + rbegcolno(rp))
  141. #define rcxtno(rp)       ((rp)->r_cxtno)
  142. #define rbegcolno(rp)    ((rp)->r_flags & _R_COL)
  143. #define ristxtfld(rp)    ((rp)->r_flags & _R_TXT)
  144. #define reof(rp)         ((rp)->r_flags & _R_EOF)
  145.  
  146. #define rgetfldpos(rp, pos)  (_rgetfldpos((rp), &(pos)))
  147. #define rsetfldpos(rp, pos)  (_rsetfldpos((rp), &(pos)))
  148.  
  149. #define rgeti(rp)        (rbgeti( (rp), 10))
  150. #define rgetl(rp)        (rbgetl( (rp), 10))
  151. #define rgetui(rp)       (rbgetui((rp), 10))
  152. #define rgetul(rp)       (rbgetul((rp), 10))
  153.  
  154. #define rcgeti(rp, begcol, endcol)  (rcbgeti( (rp), (begcol), (endcol), 10))
  155. #define rcgetl(rp, begcol, endcol)  (rcbgetl( (rp), (begcol), (endcol), 10))
  156. #define rcgetui(rp, begcol, endcol) (rcbgetui((rp), (begcol), (endcol), 10))
  157. #define rcgetul(rp, begcol, endcol) (rcbgetul((rp), (begcol), (endcol), 10))
  158.  
  159. #define rputi(rp, num)   (rbputi( (rp), 10, (num)))
  160. #define rputl(rp, num)   (rbputl( (rp), 10, (num)))
  161. #define rputui(rp, num)  (rbputui((rp), 10, (num)))
  162. #define rputul(rp, num)  (rbputul((rp), 10, (num)))
  163.  
  164. #define rcputi(rp, begcol, endcol, num)  (rcbputi( (rp), (begcol), (endcol), 10, (num)))
  165. #define rcputl(rp, begcol, endcol, num)  (rcbputl( (rp), (begcol), (endcol), 10, (num)))
  166. #define rcputui(rp, begcol, endcol, num) (rcbputui((rp), (begcol), (endcol), 10, (num)))
  167. #define rcputul(rp, begcol, endcol, num) (rcbputul((rp), (begcol), (endcol), 10, (num)))
  168.  
  169. #define strimbegs(str)           (scntrimbegs((str), ' ', SIZE_T_MAX))
  170. #define strimends(str)           (scntrimends((str), ' ', SIZE_T_MAX))
  171. #define strims(str)              (scntrims((str), ' ', SIZE_T_MAX))
  172. #define sctrimbegs(str, ch)      (scntrimbegs((str), (ch), SIZE_T_MAX))
  173. #define sctrimends(str, ch)      (scntrimends((str), (ch), SIZE_T_MAX))
  174. #define sctrims(str, ch)         (scntrims((str), (ch), SIZE_T_MAX))
  175. #define scpys(dst, src)          (_scpys(&(dst), (src)))
  176. #define scats(dst, src)          (_scats(&(dst), (src)))
  177.  
  178. #ifdef __cplusplus
  179. extern "C" {
  180. #endif
  181.  
  182. /* function prototypes */
  183. /* source: recio.c */
  184. extern void  rclose(REC *rp);
  185. extern int   rcloseall(void);
  186. extern int   risvalid(REC *rp);
  187. extern REC  *ropen(const char *filename, const char *mode);
  188. extern void  rsetbegcolno(REC *rp, int colno);
  189. extern void  rsetcxtno(REC *rp, int cxtno);
  190. extern void  rsetfldch(REC *rp, int ch);
  191. extern void  rsettmfmt(REC *rp, const char *fmt);
  192. extern void  rsettxtch(REC *rp, int ch);
  193.  
  194. /* source: rerr.c */
  195. extern void  rclearerr(REC *rp);
  196. extern int   rerror(REC *rp);
  197. extern char *rerrstr(REC *rp);
  198. extern int   rseterr(REC *rp, int errnum);
  199. extern void  rseterrfn(void(*rerrfn)(REC *rp));
  200. extern char *rstrerror(int errnum);
  201. extern void  rinit(void(*rerrfn)(REC *rp), void(*rwarnfn)(REC *rp));
  202.  
  203. /* source: remsg.c */
  204. extern void rerrmsg(REC *rp);
  205.  
  206. /* source: rwarn.c */
  207. extern void  rclearwarn